home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / languages / gawk / readme < prev    next >
Text File  |  1989-10-31  |  5KB  |  112 lines
  1. README:
  2.  
  3. This is GNU Awk 2.11. It should be upwardly compatible with the
  4. System V Release 4 awk.
  5.  
  6. This release is essentially a bug fix release.  The files have been
  7. renamed and code moved around to organize things by function.  Gawk should
  8. also be somewhat faster now.  More care has been given towards portability
  9. across different Unix systems.  See the installation instructions, below.
  10.  
  11. Known problems are given in the PROBLEMS file.  Work to be done is
  12. described briefly in the FUTURES file.
  13.  
  14. The gawk.texinfo included in this release has been revised; it should
  15. be in sync with what the code does.  The man page should also be accurate,
  16. but no promises there.
  17.  
  18. CHANGES FROM 2.10
  19.  
  20. User visible changes:
  21.     Compatibility mode is now obtained via new -c option.
  22.     The new ANSI C \a and \x escapes are now a standard part of gawk
  23.         as Unix nawk has picked them up.
  24.     The new tolower() and toupper() functions are also standard.
  25.     A new undocumented option, -nostalgia, has been added.
  26.     Command line options have changed somewhat from 2.10.
  27.         -v    is now    -V
  28.         -V    is now    -C
  29.         new -v for doing variable assignments before the BEGIN block.
  30.         new -c for compatibility mode.
  31.         new -a for awk style regexps (default)
  32.         new -e for egrep style regexps, per the POSIX draft spec.
  33.     Some more formats have been added to printf, ala nawk and ANSI C.
  34.  
  35. Other changes (the hard stuff):
  36.     All known bugs fixed.
  37.     Still more memory leaks plugged.
  38.     Lots of changes to improve performance and portability.
  39.  
  40. PC users, you've been saved!
  41.     As of patchlevel 1, we are now supplying MS-DOS "support."  Said
  42.     support was generously provided by Kent Williams, who is now
  43.     the contact person for it.  See below for his address.
  44.  
  45. INSTALLATION:
  46.  
  47. The Makefile will need some tailoring.  Currently it is set up for
  48. a Sun running SunOS 4.x and gcc.  The changes to make in the Makefile are
  49. commented and should be obvious.  Starting with 2.11, our intent has been
  50. to make the code conform to standards (ANSI, POSIX, SVID, in that order)
  51. whenever possible, and to not penalize standard conforming systems.
  52. We have included substitute versions of routines not universally available.
  53. Simply add the appropriate define for the missing feature(s) on your system.
  54.  
  55. If you have 4.2 or 4.3 BSD, you should add -DTMPNAM_MISSING since the
  56. version of tmpnam on these systems won't accept a NULL pointer.
  57. This does not apply to 4.3-tahoe or the S5R[23] systems I have access to.
  58. You need this if gawk core dumps on something simple like 'BEGIN {print "hi"}'.
  59.  
  60. If you have neither bison nor yacc, use the awk.tab.c file here.  It was
  61. generated with bison, and should have no AT&T code in it.  (Note that
  62. modifying awk.y without bison or yacc will be difficult, at best.  You might
  63. want to get a copy of bison from the FSF too.)
  64.  
  65. If you have an MS-DOS system, use the stuff in pc.d.
  66.  
  67. PRINTING THE MANUAL
  68.  
  69. The 'support' directory contains texinfo.tex 2.1, which will be necessary
  70. for printing the manual, and the texindex.c program from the emacs distribution
  71. which is also necessary.  See the makefile for the steps needed to get a
  72. DVI file from the manual.
  73.  
  74. CAVEATS
  75.  
  76. The existence of a patchlevel.h file does *N*O*T* imply a commitment on
  77. our part to issue bug fixes or patches.  It is there in case we should
  78. decide to do so.
  79.  
  80. BUG REPORTS AND FIXES:
  81.  
  82. Please coordinate changes through David Trueman and/or Arnold Robbins.
  83.  
  84. David Trueman
  85. Department of Mathematics, Statistics and Computing Science,
  86. Dalhousie University, Halifax, Nova Scotia, Canada
  87.  
  88. UUCP        {uunet utai watmath}!dalcs!david
  89. INTERNET    david@cs.dal.ca
  90.  
  91. Arnold Robbins
  92. 1315 Kittredge Court, N.E.
  93. Atlanta, GA, 30329-3539, USA
  94.  
  95. INTERNET:    arnold@skeeve.atl.ga.us
  96. UUCP:        { gatech, emory, emoryu1 }!skeeve!arnold
  97.  
  98. If you can't contact either of us, try Jay Fenlason, hack@prep.ai.mit.edu
  99. AKA mit-eddie!prep!hack.  During odd hours he can sometimes be reached at
  100. (617) 253-8975, which is an MIT phone in the middle of the corridor, so don't
  101. be suprised if someone wierd answers, or if the person on the other end has
  102. never heard of him.  (Direct them to the microvax about 10 feet to their left.)
  103.  
  104. MS-DOS SUPPORT
  105.  
  106. Support for MSC 5.1 was supplied for 2.11 by Kent Williams, who can be
  107. reached at williams@umaxc.weeg.uiowa.edu.  It relies heavily on the
  108. earlier work done for 2.10 by Conrad Kwok and Scott Garfinkle.  Bug
  109. reports on the MS-DOS version should go to Kent.  Of course, if it's
  110. a generic bug, we want to hear about it too, but if it isn't reproducible
  111. under Unix, we won't be as interested.
  112.